home *** CD-ROM | disk | FTP | other *** search
/ Aminet 15 / Aminet 15 - Nov 1996.iso / Aminet / dev / gcc / ixemsdk.lha / man / cat3 / getprotoent.0 < prev    next >
Text File  |  1996-09-02  |  3KB  |  77 lines
  1.  
  2. GETPROTOENT(3)             UNIX Programmer's Manual             GETPROTOENT(3)
  3.  
  4. NNAAMMEE
  5.      ggeettpprroottooeenntt, ggeettpprroottoobbyynnuummbbeerr, ggeettpprroottoobbyynnaammee, sseettpprroottooeenntt, eennddpprroottooeenntt -
  6.      get protocol entry
  7.  
  8. SSYYNNOOPPSSIISS
  9.      ##iinncclluuddee <<nneettddbb..hh>>
  10.  
  11.      _s_t_r_u_c_t _p_r_o_t_o_e_n_t _*
  12.      ggeettpprroottooeenntt()
  13.  
  14.      _s_t_r_u_c_t _p_r_o_t_o_e_n_t _*
  15.      ggeettpprroottoobbyynnaammee(_c_h_a_r _*_n_a_m_e)
  16.  
  17.      _s_t_r_u_c_t _p_r_o_t_o_e_n_t _*
  18.      ggeettpprroottoobbyynnuummbbeerr(_i_n_t _p_r_o_t_o)
  19.  
  20.      sseettpprroottooeenntt(_i_n_t _s_t_a_y_o_p_e_n)
  21.  
  22.      eennddpprroottooeenntt()
  23.  
  24. DDEESSCCRRIIPPTTIIOONN
  25.      The ggeettpprroottooeenntt(), ggeettpprroottoobbyynnaammee(), and ggeettpprroottoobbyynnuummbbeerr() functions
  26.      each return a pointer to an object with the following structure contain-
  27.      ing the broken-out fields of a line in the network protocol data base,
  28.      _/_e_t_c_/_p_r_o_t_o_c_o_l_s.
  29.  
  30.  
  31.            struct  protoent {
  32.                    char    *p_name;        /* official name of protocol */
  33.                    char    **p_aliases;    /* alias list */
  34.                    int     p_proto;        /* protocol number */
  35.            };
  36.  
  37.      The members of this structure are:
  38.  
  39.      _p___n_a_m_e     The official name of the protocol.
  40.  
  41.      _p___a_l_i_a_s_e_s  A zero terminated list of alternate names for the protocol.
  42.  
  43.      _p___p_r_o_t_o    The protocol number.
  44.  
  45.      The ggeettpprroottooeenntt() function reads the next line of the file, opening the
  46.      file if necessary.
  47.  
  48.      The sseettpprroottooeenntt() function opens and rewinds the file.  If the _s_t_a_y_o_p_e_n
  49.      flag is non-zero, the net data base will not be closed after each call to
  50.      ggeettpprroottoobbyynnaammee() or ggeettpprroottoobbyynnuummbbeerr().
  51.  
  52.      The eennddpprroottooeenntt() function closes the file.
  53.  
  54.      The ggeettpprroottoobbyynnaammee() function and ggeettpprroottoobbyynnuummbbeerr() sequentially search
  55.      from the beginning of the file until a matching protocol name or protocol
  56.      number is found, or until EOF is encountered.
  57.  
  58. RREETTUURRNN VVAALLUUEESS
  59.      Null pointer (0) returned on EOF or error.
  60.  
  61. FFIILLEESS
  62.      /etc/protocols
  63.  
  64. SSEEEE AALLSSOO
  65.      protocols(5)
  66.  
  67. HHIISSTTOORRYY
  68.      The ggeettpprroottooeenntt(), ggeettpprroottoobbyynnuummbbeerr(), ggeettpprroottoobbyynnaammee(), sseettpprroottooeenntt(),
  69.      and eennddpprroottooeenntt() functions appeared in 4.2BSD.
  70.  
  71. BBUUGGSS
  72.      These functions use a static data space; if the data is needed for future
  73.      use, it should be copied before any subsequent calls overwrite it.  Only
  74.      the Internet protocols are currently understood.
  75.  
  76. 4.2 Berkeley Distribution        June 4, 1993                                2
  77.